home *** CD-ROM | disk | FTP | other *** search
/ Revolution - Das Atari CD Magazin 1997 / Revolution - Das Atari CD Magazin 1.iso / software / document / profile / profile2.txt < prev    next >
Text File  |  1995-06-03  |  65KB  |  1,354 lines
  1.                              PROFILE v2.14
  2.                        THE Atari System Analyser
  3.                           by Linnhe Computing
  4.              Copyright (c) 1993, 1994, 1995 Mark S Baines
  5.                           All Rights Reserved
  6.  
  7. Mark S Baines asserts the legal and moral right to be identified as 
  8. the owner of this work.
  9.  
  10.  
  11. PROFILE 2 IS A SHAREWARE PROGRAM
  12. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  13. PROFILE 2 is protected under UK and International copyright law, and 
  14. is NOT public domain software. Mark S Baines owns the copyright to 
  15. this program and the document files.
  16.  
  17. You are hereby granted a limited licence to use this copy. You are not 
  18. allowed to alter the program in any way, to do so is an infringement 
  19. of my rights. SHAREWARE is NOT Public Domain!
  20.  
  21. Your use of the program is restricted until you register. You cannot 
  22. use any of the Save to Disk, Save to Clipboard and Print functions and 
  23. you cannot Load or Save the PROFILE2.INF Options file.
  24.  
  25. If you use this program more than once then you obviously have a need 
  26. for it. You are therefore obliged to pay me the small sum of at least 
  27. £5.00 (five UK pounds cash, postal order or UK cheque).
  28.  
  29. Please make your payment to "Mark S Baines" and **NOT** "Linnhe 
  30. Computing" and state clearly:
  31.  
  32. 1.  Your name as you want entered into the program (not more than 40
  33.     characters)
  34. 2.  Your address and e-mail address if available
  35. 3.  Which version you have
  36. 4.  Where you obtained it.
  37.  
  38. Send your payment to:
  39.  
  40.     Linnhe Computing
  41.     'Linnhe'
  42.     Shore Street
  43.     Inver, by Tain
  44.     Ross-shire
  45.     IV20 1SF
  46.  
  47. I will send you an e-mail or a letter giving you your 'key' which you 
  48. then enter into the Registration dialog (obtained from the About 
  49. dialog). This will save your key to a file and provide you with full 
  50. access to the program.
  51.  
  52. If you send an extra £1.00 (one UK pound) I will send you the latest 
  53. version on disk together with your registration key and the whole 
  54. collection of Linnhe Computing software.
  55.  
  56. See the separate document file ATOZBOOK.TXT for a special offer 
  57. concerning PROFILE 2 and The Atari A to Z book.
  58.  
  59. Bulletin Board Sysops and managers of Public Domain libraries are 
  60. allowed to make this program freely available to their users and 
  61. customers as long as the whole package remains intact and unaltered.
  62.  
  63. The FaST Club may place this program on its Disk Magazine which is 
  64. available to subscribers. Floppyshop and The FaST Club may also 
  65. include it on their Catalogue disks.
  66.  
  67. The latest version will always be available from:
  68. CIX in the atari.st/2listings topic file list.
  69.  
  70. HENSA via ftp, telnet, gopher at micros.hensa.ac.uk
  71.     /micros/atari/tos/p/p143 directory.
  72.  
  73. Versions are also available at the following but not necessarily the 
  74. latest (they are increasingly difficult to log onto!):
  75.  
  76. Paderborn in Germany via ftp.uni-paderborn.de
  77.     /atari/tools/util directory.
  78.  
  79. University of Michigan in the US via ftp atari.archive.umich.edu
  80.     /Utilities/Benchmark directory.
  81.  
  82. Imperial College mirror sites via ftp src.doc.ic.ac.uk
  83.     /packages/atari/umich/
  84.     /packages/atari/uni-paderborn directories.
  85.  
  86. The file name will always be PROF2_xx.ZIP where xx is the minor 
  87. version number. This version is called PROF2_14.ZIP, for instance.
  88.  
  89. Remember that registering PROFILE 2 for the sum of £6.00 (six UK 
  90. pounds) entitles you to the latest version on disk from me. After 
  91. registration, return the master disk with £1.00 (one UK pound) at any 
  92. time to get the latest disk version.
  93.  
  94.  
  95. PROFILE 2 and MAGAZINE EDITORS
  96. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  97. No other magazine, whether commercial or free, professional or 
  98. amateur, may place PROFILE 2 on a disk magazine or magazine cover disk 
  99. without the express written permission of Mark S Baines at the above 
  100. address. This especially applies to ST Format and Atari World. Mark S 
  101. Baines reserves the right to demand the appropriate remuneration from 
  102. commercial magazines and disk magazine publishers for permission to 
  103. publish PROFILE 2 on their disks. If you make a profit out of selling 
  104. a magazine with a cover disk, then it is only right that some of that 
  105. profit should be distributed to the authors of the software contained 
  106. therein, just as you pay the writers that supply your copy.
  107.  
  108.  
  109. PROFILE 2 and SOFTWARE COMPANIES
  110. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  111. No software or hardware company or distributor is allowed to include 
  112. PROFILE 2 with any of their software without the express written 
  113. permission of Mark S Baines at the above address. I am very receptive 
  114. to such an idea but you must contact me first.
  115.  
  116. I have recently written a very cut-down version called PROFILE LITE 
  117. which you may find more satisfactory as the whole package occupies 
  118. less than 50K. This version can be personalized to suit your needs 
  119. including the help information and the charge for its use if very 
  120. reasonable. It is already in use with one company. Again, contact me.
  121.  
  122.  
  123. PROFILE 2 - INVENTORY
  124. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  125. When distributed through any means whatsoever, this total package must 
  126. not be separated.
  127.  
  128. PROFILE2.PRG  The program
  129. PROFILE2.RSC  The resource file
  130. PROFILE2.TXT  The documentation in standard ASCII text file
  131. PROFILE2.ASC  The documentation in reformatable ASCII text file
  132. PROFILE2.HYP  The ST-Guide hypertext help file
  133. PROFILE2.REF  The ST-Guide reference file
  134. PROF2ICN.RSC  The PROFILE 2 Desktop icon
  135. PROFILE2.NIC  The PROFILE 2 NeoDesk icon
  136. ROCP.PRG      A Read Only Control Panel program which sets the
  137.               DESKTOP/NEWDESK.INF values as current
  138. ATOZBOOK.TXT  Information on my book "The Atari A to Z" including a
  139.               special offer
  140.  
  141.  
  142. PROFILE 2 - WHAT IS IT?
  143. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  144. Atari, in their wisdom, have created a situation where there are many 
  145. different types of STs, TTs and Falcons around the world. What have we 
  146. got?
  147.  
  148. There are at least 15 different TOS versions, many different versions 
  149. of GEMDOS and the AES, different versions of GDOS (GDOS, FONTGDOS, 
  150. FSMGDOS and SpeedoGDOS), 17 different nationalities of ROM, BLiTTER 
  151. chips, different resolutions and many different amounts of RAM memory 
  152. from 256K to 4Mb on an ST and beyond on TTs and Falcons. I'll leave it 
  153. to you to work out all the different permutations.
  154.  
  155. All this can create problems for software developers and subsequent 
  156. 'bug' troubleshooters. If you contact your software company for some 
  157. technical advice, reporting a bug or undocumented 'feature', it is a 
  158. great help to them to know what system the program is running on. 
  159. HiSoft provide a program called CHECKST.PRG which produces this 
  160. information but it is not Public Domain. I therefore started writing 
  161. programs which do the same sort of thing (and more besides) for all 
  162. you non-HiSoft software users!
  163.  
  164. PROFILE 2 is a development of PROFILE 1 which in turn evolved from 
  165. ST_DATA2 and ST_TYPE. ST_DATA2 and ST_TYPE have known problems 
  166. although updated versions of ST_DATA2 are available. ST_TYPE is not 
  167. supported any more and cannot be relied upon, unfortunately. You 
  168. should not be using it. ST_DATA2 ceased to be supported with the 
  169. release of PROFILE 1. PROFILE 1 ended development with v1.53 and is 
  170. essentially the same as PROFILE 2 but using the TOS interface. It also 
  171. doesn't produce such an extensive report as PROFILE 2.
  172.  
  173. At its simplest level, PROFILE 2 can tell you what TOS you have; its 
  174. date and how much memory you have; whether the installed DESKTOP.INF 
  175. configuration is valid; what the mouse double-click speed is; whether 
  176. a Cookie Jar is installed...
  177.  
  178. Power users; programmers; people who like to hack about with other 
  179. people's code and programs; hardware and system developers; repairers; 
  180. those wanting to get the best from the configuration of their system 
  181. with numerous ACCs and AUTOs and any other nosey folk, all want to 
  182. know what exactly they have in front of them and what is going on 
  183. behind the scenes. PROFILE 2 provides extensive information to help 
  184. you sort out which vectors are pointing where, what VBLs are set and 
  185. the nature of the installed Cookie Jar (if present) and more. This 
  186. level of use requires knowledge of the system and what the details 
  187. reported by PROFILE 2 mean. I'm not going to explain them all here I'm 
  188. afraid, on the basis that if you don't know what they mean then you 
  189. don't need to know what the values are. Sources of data are few and 
  190. far between and the following may help:
  191.  
  192. Modern Atari System Software (1993); HiSoft; ISBN 0-948517-63-8; 
  193. HiSoft
  194.  
  195. The Atari Compendium (1993); Sanders, Scott; ISBN 0-9638331-0-3; SDS 
  196. Publishing
  197.  
  198. The Atari A to Z; (1995); Mark S Baines; Linnhe Computing (see 
  199. separate document file ATOZBOOK.TXT)
  200.  
  201. Atari ST Internals (1988); R. Brückman, L. Englisch and K. Gerits; 
  202. ISBN 0-916439-46-1; Data Becker GmbH
  203.  
  204. Concise Atari ST 68000 Programmer's Reference (1986); K. Peel; ISBN 1-
  205. 85181-017-X; Glentop Publishers Ltd.
  206.  
  207. A Hitchhikers Guide to the BIOS (1986); Atari Corp. PD text file
  208.  
  209. Rainbow TOS Release Notes (1989); Atari Corp.
  210.  
  211. STE TOS Release Notes (1989); Atari Corp.
  212.  
  213. TT030 TOS Release Notes (1990); Atari Corp.
  214.  
  215. Atari DocSupport Developer's Kit (1991); Atari Corp.
  216.  
  217. ST Application magazine, (monthly); FaST Club
  218.  
  219. Compiler program manuals are good sources of this sort of 'inside' 
  220. information. It's also surprising what is available as text files on 
  221. the Bulletin Board networks and through PD libraries!
  222.  
  223. PROFILE 2 can be run under two kinds of conditions. Firstly, in an 
  224. empty system devoid of accessories and AUTO folder programs, under GEM 
  225. and from a floppy. This will tell you what sort of default set up you 
  226. have and be your standard for telling others, such as software 
  227. companies, what system you have. Computer repairers and upgraders 
  228. often need this information as well as the private user wanting to 
  229. confirm his purchase.
  230.  
  231. Secondly, you may run PROFILE 2 under various configurations, with 
  232. hard disk boot programs, accessories, AUTOs, desktop replacements, 
  233. hardware modifications etc. and see what effect these programs have on 
  234. your system. Changing the configuration of your system (programs like 
  235. Superboot and XBoot make this incredibly easy and convenient) will 
  236. tell you much about the effects of individual programs and what they 
  237. do to your computer and perhaps to each other. This can be an 
  238. invaluable aid to bug hunting, virus hunting, program 
  239. incompatibilities etc.
  240.  
  241.  
  242. PROFILE 2 - THE REPORT
  243. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  244. PROFILE 2 will print a report to the screen, printer or disk of your 
  245. computer's hardware and software configuration.
  246.  
  247. A list of the pages provided is:
  248.  
  249. 1   Hardware, TOS and Screen Details
  250.     F1 key
  251.     Most of this is self explanatory. Some of it will only appear if
  252.     you have a Cookie Jar installed with relevant values although if
  253.     the CPU and FPU are not found in a Cookie Jar then some other code
  254.     is used to determine what is available. However, this code isn't
  255.     thorough and the Cookie Jar values take precedence. Some items
  256.     default to the basic type (Machine, Floppy Disk Drive). If PROFILE
  257.     2 reports an incorrect value then perhaps you ought to update your
  258.     Cookie Jar with a suitable program. For full information on some
  259.     of these items refer to the Cookie Jar page.
  260.  
  261.     Note that the two alternative numbering systems for the TOS
  262.     version number have been used where appropriate. Therefore, TOS
  263.     1.04 is the same as 1.4. It is my contention that Atari's attempt
  264.     to change the TOS numbering system for the early TOSes after the
  265.     old numbers have been accepted for several years, is ridiculous.
  266.     To add to the confusion they still refer to both TOS numbers in
  267.     documentation and in personal conversations. TOS 1.0 remains so or
  268.     may be called TOS 1.00. Atari would like to change TOS 1.2, 1.4
  269.     and 1.6 to TOS 1.02, 1.04 and 1.06. However, TOS 1.62 remains as
  270.     such which implies a far greater upgrade from TOS 1.06 than
  271.     actually took place! (I saw someone sadly refer to TOS 1.62 as
  272.     1.062 recently! You can't get 1.062 from the BCD value $0162 in
  273.     the ROM code and this just demonstrates the confusion that Atari
  274.     have caused).
  275.     The TOS version number is contained in the ROM at offset $02.
  276.  
  277.     As far as I know, the present TOS version numbers are thus:
  278.  
  279.         os_version    Old     New     Name
  280.         _sysbase+2    Number  Number
  281.  
  282.         0x0100        1.0     1.00    ROM TOS or Old TOS
  283.         0x0102        1.2     1.02    BLiTTER TOS or Mega TOS
  284.         0x0104        1.4     1.04    Rainbow TOS
  285.         0x0106        1.6     1.06    STE TOS
  286.         0x0162        1.62    1.62    STE TOS
  287.         0x0201                2.01    Mega STE TOS
  288.         0x0205                2.05    Mega STE TOS
  289.         0x0206                2.06    Mega STE TOS
  290.         0x0301                3.01    TT030 TOS
  291.         0x0305                3.05    TT030 TOS
  292.         0x0306                3.06    TT030 TOS
  293.         0x0400                4.00    Falcon TOS
  294.         0x0401                4.01    Falcon TOS
  295.         0x0402                4.02    Falcon TOS
  296.         0x0404                4.04    Falcon TOS
  297.  
  298.     Numbers not in this list are third party modifications such as
  299.     1.41.
  300.  
  301.     Some people have claimed to have a TOS 1.09 in the UK. It has
  302.     always been my belief up until recently, that this was due to
  303.     certain programs inaccurately reporting the GEMDOS version rather
  304.     than the TOS version number. TOS 1.0 and 1.2 do have a GEMDOS
  305.     version number of 0.19. After some recent discussions on the BBS
  306.     networks, it would appear that a true version number of TOS 1.09
  307.     does exist. It is not, however, a mainstream TOS and it would
  308.     appear that it is a pre-TOS 1.2 version that Atari UK produced to
  309.     cater for the BLiTTER chip before TOS 1.2 was made available by
  310.     Atari US.
  311.  
  312.     There is a little confusion over the GEMDOS version number and
  313.     whether it should be shown as hex/BCD format as with the TOS
  314.     version number or decimal format. This gives two differing
  315.     numbers, of course. The GEMDOS version number for TOS 1.4 could be
  316.     0.15 or 0.21 according to which format you subscribe to. Atari
  317.     choose the former and I make it the default here but also show the
  318.     decimal format.
  319.  
  320.     An attempt is made to work out the effective processor speed
  321.     compared to a 8 MHz MC68000. The reported speed does not take the
  322.     RAM caches of hardware accelerators or CPU on-chip caches into
  323.     account, so that the speed IS NOT the hardware CPU rate but the
  324.     effective processing speed of the CPU *relative* to a 8 MHz 68000.
  325.     This figure may vary slightly depending on what processes you have
  326.     going on in the background, for instance AUTO folder TSRs and
  327.     accessories. Compare the 'empty system' result with other
  328.     configurations to see how some software may affect the speed of
  329.     your computer. Please also note that this is the CPU speed and NOT
  330.     the speed of the computer as a whole. In other words, if PROFILE
  331.     reports that you CPU is comparable to 2.5 times that of a 8 MHz
  332.     68000, it DOES NOT mean that, say, uncompressing files or
  333.     scrolling through a text file is 2.5 times faster.
  334.  
  335.     On a Falcon030 and computers with video cards the Current Getrez
  336.     Screen Mode will report an incorrect value except with ST
  337.     compatible modes. This isn't a fault of PROFILE 2 but the
  338.     resolution the computer sees itself running using the old and
  339.     almost defunct Getrez() function. The function should return a
  340.     value of 3 for a Falcon030, for instance, but usually returns a
  341.     value of 2 which means ST High Resolution Mono mode. Whether this
  342.     is a bug in TOS 4 is yet to be determined.
  343.  
  344.     Some users are confused as to what PROFILE 2 reports here. No
  345.     program should use Getrez() to find out the resolution of the
  346.     screen as its return values are too limited and don't allow for
  347.     video cards, overscanned screens and the Falcon030. However, some
  348.     programs *do* still use it and can give problems for a user when
  349.     they come up with a "Can't run in this resolution" alert. PROFILE
  350.     2 reports this value so that the user may know what screen mode
  351.     the system thinks it is running in using the Getrez function and
  352.     so help to sort out these problems.
  353.  
  354.     Apart from this use, this information is meaningless on anything
  355.     but a standard ST(E). For the true screen resolution and other
  356.     video details see the "Current Resolution" and following lines on
  357.     this page.
  358.  
  359. 2   Memory Details
  360.     F2 key
  361.     The total amount of ST RAM and Alternate RAM (TT chip RAM only) is
  362.     reported as well as that used, free and the largest single free
  363.     block of each. However, on a TT the total amount of Alternate RAM
  364.     can only be calculated by an undocumented feature, which is simple
  365.     enough but relies on that memory always starting at the address
  366.     $01000000. There is no 100% guarantee that it always will, but
  367.     then there is no real reason why it shouldn't. If this causes
  368.     problems, then please tell me. Which items are reported on this
  369.     page depends on what is installed and available.
  370.  
  371.     There is a problem with virtual memory (which appears as
  372.     alternative memory) as there is no way to know what the total
  373.     amount installed is, just the total amount that is free. If you
  374.     have virtual memory then some calculations can not be performed
  375.     and do not appear.
  376.  
  377.     Percentage values are shown as a percentage of the relevant total
  378.     value, that is, if the value refers specifically to ST or TT RAM
  379.     then the percentage is a reference to the separate total ST or TT
  380.     RAM values. If the value doesn't refer to any specific type of RAM
  381.     then the percentage refers to the total available memory including
  382.     TT RAM if available.
  383.  
  384. 3   Disk Drives Details
  385.     F3 key
  386.     Again, mostly self-explanatory. The BIOS Parameter Block or BPB of
  387.     all mounted drives is shown where possible. This information is
  388.     stored on the disk and informs TOS of the details of the drive's
  389.     format. TOS needs to know how big the sectors are and where the
  390.     FAT and data sectors start.
  391.  
  392.     Only those drives where the BPB is available are shown, non-hard
  393.     disks (CD-ROMs etc.) are skipped if certain functions return an
  394.     error. Also note that a floppy drive A: or B: is only shown if it
  395.     is the current drive on the assumption that a disk is still
  396.     present in the drive. If there isn't a disk present then the
  397.     system may ask you to insert one or sometimes lock up.
  398.  
  399. 4   pun_info Structure Details
  400.     The pun_info structure is provided by TOS for any hard disk driver
  401.     to make a relationship between the logical drives installed on the
  402.     desktop and the physical units connected to the computer. Logical
  403.     drives A: and B: are assumed to be floppies and everything else a
  404.     hard disk. RAM disks are reported in the list of logical drives
  405.     (as they are on page 3) but they are not included in the
  406.     'Partitions' table as they do not have a physical unit
  407.     counterpart.
  408.  
  409.     Not all hard disk drivers fully initialize the pun_info structure.
  410.     As far as I know, only Atari's AHDI version 3 or later does and
  411.     also uses the extended pun_info data at the end of the structure.
  412.     The commonly used ICD drivers do not even properly initialize the
  413.     table linking the logical units with the physical sectors. With
  414.     all versions of the ICD drivers up to v6.5.5, the partition start
  415.     sector is offset by four partitions, so that the start sector for
  416.     partition C is that listed under partition G, partition H is for D
  417.     and so on. However, the ACSI device number is correct for each
  418.     partition. Also, under some ICD drivers, the ACSI device number
  419.     for a partition that doesn't physically exist (should be 7 but
  420.     usually found to be 4) and the flag that designates the physical
  421.     presence of a device are also wrong. Here, PROFILE 2 interprets
  422.     everything as physically existing whether it does or not. Do note
  423.     that this ISN'T a fault in PROFILE 2.
  424.  
  425.     Under AHDI drivers, an ACSI device number of 7 designates that
  426.     that partition does not exist (accepted range is 0 - 6) and should
  427.     relate to the list of logical devices above that (RAM disks
  428.     excepting, of course). I also list the Driver ID found before the
  429.     pun_info structure for non-AHDI drivers but this doesn't seem to
  430.     be in standard use except by ICD.
  431.  
  432.     I have no plans to compensate for the ICD partition start sector
  433.     error although it has been requested several times. The job of
  434.     PROFILE 2 is to report what it finds, not what I or you want it to
  435.     find. Massaging the data would only lead to confusion, the user
  436.     never knowing whether what they saw actually existed in their
  437.     system or just in PROFILE's window.
  438.  
  439. 5   ROM Cartridge Details
  440.     F4 key
  441.     If a program cartridge is attached then the details of this are
  442.     reported. The cartridge has to have a program ROM installed, so
  443.     cartridges that are just dongles or interfaces for hardware, such
  444.     as scanners, are not seen by your system or PROFILE 2 as there is
  445.     nothing to report.
  446.  
  447.     This page is disabled if running under MagiCMac on an Apple Mac
  448.     which, of course, doesn't have a Cartridge port.
  449.  
  450. 6   Serial Devices Details
  451.     F5 key
  452.     These are the current values for various parameters including the
  453.     buffer lengths for the serial devices including the serial port,
  454.     keyboard and midi ports. If the system supports the Bconmap()
  455.     function (Mega STE, TT and Falcon, and any other computer running
  456.     HSMODEM serial port enhancer or MagiC operating system) then all
  457.     the available devices are shown together with the contents of the
  458.     BCONMAP structure. Do note that on Falcons the default serial port
  459.     device is device 6 and not device 7 despite documentation
  460.     elsewhere indicating that device 6 is illegal. Device 6 is the MFP
  461.     compatible port which exists but isn't connected to any external
  462.     port on the back of the computer. Some programs will set the
  463.     default port to device 7 but most (such as HSMODEM) only access
  464.     device 7 without making it the default device. This can lead to
  465.     some confusion when examining the parameters of the serial port
  466.     device and why PROFILE v2.09 now shows all the available devices.
  467.  
  468.     These values may not match some of those in the AES shell buffer
  469.     page unless this shell buffer is made active by saving the
  470.     Desktop.
  471.  
  472. 7   Miscellaneous Falcon030 Details
  473.     F6 key
  474.     Various specific Falcon030 details are reported here such as the
  475.     video mode and whether the DSP or sound system has been taken
  476.     over. The video mode details are the currently set ones and may
  477.     disagree with those set on the Desktop and shown in the
  478.     NEWDESK.INF details page if the latter hasn't been saved. This
  479.     page is disabled on non-Falcons.
  480.  
  481. 8   AES Details
  482.     F7 key
  483.     A report on the AES version number and other details, most of
  484.     which is only available with AES version 4.00 and even more with
  485.     version 4.10. However, these details are also shown if MagiC or
  486.     Geneva operating systems are loaded. These details will be useful
  487.     to programmers wanting to know about software compatibility.
  488.  
  489. 9   Multitasking System Details
  490.     F8 key
  491.     If MiNT or the MiNT kernel of MultiTOS, MagiC or Geneva is
  492.     installed then some details are shown. The details vary according
  493.     to what is available from data structures the systems set up. This
  494.     page is disabled on singletasking systems.
  495.  
  496. 10  Multitasking System - Configuration File
  497.     A display of the current MINT.CNF, MAGX.INF or xxx configuration
  498.     file depending on the multitasking system installed. This page is
  499.     disabled on singletasking systems.
  500.  
  501. 11  Multitasking System - GEM.CNF File
  502.     A display of the current GEM.CNF configuration file for MultiTOS
  503.     or Geneva. This page is disabled on systems without MiNT/MultiTOS
  504.     or Geneva installed.
  505.  
  506. 12  Some Important System Configuration Addresses
  507.     F9 key
  508.     This page contains some of the most important items that people
  509.     may need to know at a glance. They are mostly repeats of details
  510.     contained elsewhere (System Variables especially) but have the
  511.     advantage of having a little explanation and contained together.
  512.     Some of these are important if you suspect the presence of a virus
  513.     attaching itself to the Reset Vector or Hard Disk routines, for
  514.     instance. These details can be followed up on page 23 perhaps
  515.     using the XBRA checks.
  516.  
  517.     Checks are made on the Reset Vector values and those for the
  518.     Memory Configurations to note their validity.
  519.  
  520. 13  Operating System Header Block Details
  521.     F10 key
  522.     This is simply a record of the first bytes in the TOS ROMs pointed
  523.     to by the system variable _sysbase, where some important hard-
  524.     coded details are kept. Some of these details do not appear on TOS
  525.     1.0 STs.
  526.  
  527.     Note that under operating systems loaded in from disk, such as
  528.     MultiTOS, MagiC and Geneva, some of these details will not reflect
  529.     those in the actual ROM code.
  530.  
  531. 14  Program Basepage Details
  532.     Shift-F1 key
  533.     The BASEPAGE structure is detailed here for the current program
  534.     i.e. PROFILE 2, PROFILE 2's parent process, its grandparent and
  535.     great-grandparent processes if available. The parent is normally
  536.     the Desktop or replacement Desktop or Shell program, that is, the
  537.     program that PROFILE 2 was launched from. It is envisaged that it
  538.     will be this list that users will find useful rather than the
  539.     current process basepage.
  540.  
  541. 15  AES Internal Shell Buffer - The Installed DESKTOP/NEWDESK.INF File
  542.     Shift-F2 key
  543.     This is the AES shell buffer, that is, the installed version of
  544.     the DESKTOP/NEWDESK.INF file in memory and not necessarily current
  545.     and the same as the DESKTOP/NEWDESK.INF file on disk. It is
  546.     important that you realise this. What PROFILE 2 is showing is the
  547.     shell buffer that the system and other programs will be looking
  548.     at. If your NEWDESK.INF file is very large it may get truncated
  549.     here I'm afraid.
  550.  
  551.     If MagiC or MagiCMac are loaded then the AES shell buffer will
  552.     contain the control panel and desktop information part of the
  553.     MAGX.INF file (from the #_CTR delimiter). This is displayed
  554.     instead of the DESKTOP/NEWDESK.INF information which is inactive
  555.     and meaningless under MagiC.
  556.  
  557. 16  AES Internal Shell Buffer - The Installed Configuration
  558.     These details are a report on the configuration of the AES's
  559.     internal shell buffer. Under MagiC or MagiCMac, only the
  560.     DESKTOP/NEWDESK.INF '#a', '#b', and '#c' lines are used and
  561.     therefore reported here. The AES internal shell buffer is only
  562.     updated when the Desktop is saved and so any changes made without
  563.     saving the Desktop will not be detected by PROFILE 2.
  564.  
  565.     Note that for the RGB Colour Values there are sixteen sets of
  566.     three digits, each digit for Red, Green and Blue. On the ST, this
  567.     range of digits for each colour value is 0 to 7, so that white is
  568.     000 and black is 777. However, on the STE, the colour range was
  569.     extended to fifteen, but instead of using the hexadecimal
  570.     representation of numbers Atari chose to use the character set 0
  571.     to 9 and : for 10, ; for 11, < for 12, = for 13, > for 14 and ?
  572.     for 15. Therefore, if you get a RGB colour value of "?;<" it isn't
  573.     nonsense but means 15 11 12.
  574.  
  575.     The representation of some of the values shown here may differ
  576.     from those on page 15. Note that the system will install a default
  577.     set up if a DESKTOP/NEWDESK.INF file isn't available at boot up. I
  578.     really recommend a ROCP (Read Only Control Panel) program, which
  579.     is supplied and should be run from the Desktop after boot up. It
  580.     reads the installed DESKTOP.INF file in memory, activates the
  581.     settings and quits.
  582.  
  583.     If NEWDESK.INF is used instead of DESKTOP.INF then more details
  584.     are displayed. Extra NEWDESK.INF file settings for TOS 4 on the
  585.     Falcon030 are also shown concerning the video setup. There appears
  586.     to be an additional problem in that the XCONTROL PANEL accessory
  587.     doesn't update the DESKTOP/NEWDESK.INF file when making changes to
  588.     the Serial port and Printer details. Here, the earlier CONTROL
  589.     PANEL had an advantage and may be used to install a
  590.     DESKTOP/NEWDESK.INF file with the correct '#a' and '#b' lines
  591.     before using the XCONTROL PANEL. Again note, that the Falcon030
  592.     video mode details here may not agree with those displayed on page
  593.     7. Save the Desktop then they should both agree.
  594.  
  595. 17  Control Panel Settings and GDOS
  596.     Shift-F3 key
  597.     PROFILE 2 can distinguish between the four types of GDOS (GDOS,
  598.     FONTGDOS, FSMGDOS and SpeedoGDOS). Some copies of FSMGDOS are
  599.     available but officially it was never released by Atari. It was
  600.     replaced by SpeedoGDOS.
  601.  
  602.     The other items reported here are controlled by Control Panel type
  603.     programs and may be contained in the DESKTOP.INF or NEWDESK.INF
  604.     file and these are the currently installed values. These may
  605.     differ from those in the DESKTOP.INF or NEWDESK.INF file itself
  606.     because another program has taken over the setting of these items,
  607.     such as NeoDesk. Also, be aware that some of the DESKTOP.INF file
  608.     settings are not installed unless a Control Panel program is run
  609.     or a Read Only Control Panel.
  610.  
  611. 18  GDOS - ASSIGN.SYS File
  612.     A display of the current GDOS ASSIGN.SYS file.
  613.  
  614. 19  GDOS - EXTEND.SYS File
  615.     A display of the current GDOS EXTEND.SYS file.
  616.  
  617. 20  AUTO Folder Programs
  618.     Shift-F4 key
  619.     This is a list of the active programs in the AUTO folder on the
  620.     boot drive. I just look for the files with the PRG filename
  621.     extender. Therefore, the list may not be an accurate one of those
  622.     files that were installed in the system at boot-up if you changed
  623.     the name of a program afterwards.
  624.  
  625. 21  Accessories
  626.     This is a list of the accessories found. I just look for the files
  627.     with the ACC filename extender. Therefore, the list may not be an
  628.     accurate one of those files that were installed in the system at
  629.     boot-up if you changed the name of a program afterwards. However,
  630.     I do check to see whether they are installed or not and if so,
  631.     report their application id number.
  632.  
  633.     I also try to look in the right places for the accessories. If you
  634.     have an ACCPATH environment variable set for various paths where
  635.     you have installed them then I look there, or check the root
  636.     directory of the boot drive. Failing that I look for folders
  637.     called \ACC or \ACCS.
  638.  
  639. 22  CPX Modules
  640.     This is a list of the active CPX modules. I just look for the
  641.     files with the CPX filename extender after checking in the
  642.     CONTROL.INF file which should contain the path of the folder
  643.     containing the CPX files. Therefore, the list may not be an
  644.     accurate one of those files that were installed in the system at
  645.     boot-up if you changed the name of a program afterwards.
  646.  
  647. 23  Applications
  648.     Available only under multitasking systems, this is a list of all
  649.     the active applications in memory. The application type and id
  650.     number are also shown.
  651.  
  652. 24  Vertical Blank Interrupt Details
  653.     Shift-F5 key
  654.     Many accessories and AUTO folder programs need to keep doing
  655.     something periodically after being loaded, that is, they stay in
  656.     memory and are a form of multitasking (though not in the proper
  657.     sense of the word). These are TSR programs or Terminate and Stay
  658.     Resident programs. Some install routines as Vertical Blank
  659.     routines or VBLs. These are called every time the screen raster
  660.     scan moves from the bottom right hand corner to the top left of
  661.     the screen when drawing the screen display. This occurs every 70th
  662.     of a second on a mono monitor such as the SM124/5 and every 50th
  663.     or 60th of a second on ST colour monitors or TVs. Again, you can
  664.     check on these addresses on pages 23 - 28 to see if any of them
  665.     were installed by XNAM compliant programs. Memory monitor programs
  666.     can be used to see what is present at these addresses as well.
  667.  
  668.     Although it is possible, but unusual, to have more that eight
  669.     VBLs, eight is the default number in every system. PROFILE 2 makes
  670.     no attempt to look for any more. If there is a need for this then
  671.     please let me know.
  672.  
  673. 25  Cookie Jar Configuration Details
  674.     Shift-F6 key
  675.     The Cookie Jar was introduced with TOS 1.6 and is automatically
  676.     installed in TOSes 1.6 and later. It is possible to modify or
  677.     install your own Cookie Jar in any system with any TOS. The Cookie
  678.     Jar is an attempt to provide programs with information about the
  679.     type of system they are running on, especially the type of
  680.     hardware. This would normally be difficult for any program to
  681.     establish. Many programs need to know which processor is installed
  682.     and whether a floating point coprocessor is available so as to
  683.     make use of their facilities. The type of video SHIFTER and sound
  684.     facilities are also different on various systems and a graphics
  685.     program may need to know if the STE type video SHIFTER is
  686.     installed to use the extra colours present.
  687.  
  688.     The Cookie Jar is a list of IDs and values, stored in memory the
  689.     address of which is pointed to by the system variable _p_cookies
  690.     at address $5A0. The values often just show the presence of a
  691.     machine's facility or its type or the presence of an active TSR
  692.     program. Other values may be addresses of routines or data
  693.     structures in memory or a version number. There is no standard for
  694.     these. IDs are four ASCII characters and each should be unique and
  695.     descriptive. Atari have reserved the underline character '_' as
  696.     the first character of their IDs.
  697.  
  698.     This page lists in order the IDs and their values in hex, ASCII
  699.     and decimal and the size of the Cookie Jar. Note that any Cookie
  700.     Jar program can modify the size of the Cookie Jar. Some programs
  701.     use incorrect characters for the Cookie ID and PROFILE 2 tries to
  702.     trap these. Atari's own MACCEL3 is one of these with the intention
  703.     of making its Cookie ID of $AA006E look like MOOSE which is
  704.     supposedly close enough to be mistaken for MOUSE! Absolutely
  705.     pathetic - talk about breaking your own rules!!
  706.  
  707. 26  Cookie IDs Interpretation
  708.     This page interprets the values of the Official Atari IDs and
  709.     other selected and significant non-Atari ones. Recognizing an ID
  710.     is usually simple enough, for instance, "OVER" means OverScan,
  711.     "FrmD" is FormDoIt, "LTMF" is Let 'em Fly, "NFnt" is NeoDesk Font,
  712.     "NLdr" is NeoDesk Loader etc. etc. However, understanding what
  713.     their values mean is anybody's guess and usually of no concern
  714.     anyway. Some are version numbers, others are addresses in RAM
  715.     where that program is loaded and some point to another identifier
  716.     (usually four characters) or a version number in memory. In most
  717.     cases it doesn't matter to the user what they mean.
  718.  
  719.     PROFILE 2 is capable of detecting all the official and semi-
  720.     official Atari Cookies, the latter of which include the presence
  721.     of the new GDOSes, Poolfix, TOS 1.6 patch, MiNT Kernel and the
  722.     Diablo driver for SLM laser printer. The new International Date
  723.     and Time Cookie and Nationality Language/Keyboard Cookie are
  724.     included and versions of various installed software that have
  725.     written a cookie shown, such as _NET, _FLK and MiNT.
  726.  
  727.     I also check for some other significant programs, the current list
  728.     being: MagiC, MagiCMac, Geneva, NeoDesk, Outside, VRAM, NVDI,
  729.     OverScan, UIS3, VFIX, FormDoIt, Selectric (FSEL), Let 'em Fly,
  730.     Virtual Screen (VSCR).
  731.  
  732. 27  Environment Variables Strings
  733.     Shift-F7 key
  734.     Many alternative desktops, command line interface shells and
  735.     programs set up environment variables in particular the PATH=
  736.     variable which informs TOS or any program which directories to
  737.     search through when looking for resource or data files.
  738.  
  739.     The standard GEMDOS environment string set up for the AUTO folder
  740.     and Desktop has a bug where a nul is placed after the '=' sign as
  741.     in PATH=$0A:\$0$0. It should not be there. The two trailing nuls
  742.     correctly designate the end of the strings. Secondly, it is always
  743.     drive A:\ even if booting from drive C:\. Some programs get around
  744.     this and some others misuse it. Atari have recommended that it
  745.     shouldn't be used. I trap this and show you it exists, if present.
  746.  
  747. 28  Complete System Variables Contents
  748.     Shift-F8 key
  749.     This is the complete list as of TOS 4. The address and official
  750.     Atari name is given together with the values they contain in hex
  751.     and decimal. I've added some prefixes to some names to aid
  752.     identification. These are where a system variable is 'divided'
  753.     into many parts, like _themd which consists of four longs and
  754.     _bufl which consists of two. I've given these suffixes to indicate
  755.     which long is referenced. The same applies for each of the
  756.     _vbl_list, xconstat, xconin, xcostat and xconout system variables
  757.     where I've added a number on the end.
  758.  
  759.     Please note that some of these names are not the same as those in
  760.     The Hitchhiker's Guide, Atari ST Internals and even The Atari
  761.     Compendium. My names are taken from official Atari US source code
  762.     and developer's documentation and are correct to the best of my
  763.     knowledge.
  764.  
  765. 29  Exception Vectors Contents - First 32
  766.     Shift-F9 key
  767. 30  Exception Vectors Contents - TRAPs
  768. 31  Exception Vectors Contents - FPU and MMU Interrupts
  769. 32  Exception Vectors Contents - MFP 68901 Interrupts
  770. 33  Exception Vectors Contents - TT MFP and SCC Interrupts
  771.     Only those Exception Vectors that are important and usually of
  772.     significance are shown. Those after $1BC are undefined and not
  773.     shown.
  774.  
  775.     In systems with a MC68000 CPU with 24-bit addressing, many of the
  776.     values shown are in two parts. The last six hex digits are an
  777.     address of a routine executed in ROM when that exception is called
  778.     due to some sort of error when a crash may be imminent. The first
  779.     two hex digits (upper byte) are the number of bombs shown just
  780.     before that crash and is the same as the vector number (in hex).
  781.     Because of this pattern, scanning down the list can show quite
  782.     easily any vectors taken over by user programs installed in the
  783.     system. In TOS 3 and 4 systems with 68030 processors, if the first
  784.     two hex digits do exist they are part of the vector address.
  785.  
  786.  
  787. XBRA and XNAM
  788. ¯¯¯¯¯¯¯¯¯¯¯¯¯
  789. The System Variables and Exception Vectors can be analysed for XBRA 
  790. and XNAM compliance providing a powerful debugging tool for software 
  791. and system developers. Some system variables and all the exception 
  792. vectors contain vector addresses, that is, addresses that point to 
  793. another part of memory that may be the start of an executable routine.
  794.  
  795. Many AUTO folder programs such as TSRs (Terminate and Stay Resident) 
  796. and accessories install themselves in memory using the XBRA and XNAM 
  797. protocols. Essentially, they hook into or take over various vectors, 
  798. such as those pointed to by some system variables or exception 
  799. vectors, so that when TOS (or other programs) transfer control via 
  800. these vector addresses to run the routine pointed to by them, the TSR 
  801. routine is run instead. Normally, if several of these programs want to 
  802. do this to the same vector then problems could arise. Some programs do 
  803. not save the address originally stored at this vector and so the last 
  804. installed program usually wins kicking out the others. Most others do 
  805. save the vector address but do so in non-standard ways incompatible 
  806. with each other. The XBRA protocol, however, does introduce a standard 
  807. so that each program can store the vector address and replace it with 
  808. its own in a compatible manner. After any XBRA compliant program is 
  809. called and run, it can then call the old address thus enabling another 
  810. previously installed program to run and so on down the chain until the 
  811. last original address is reached. In this way, all the programs get to 
  812. run their routines at the appropriate time. Note, however, that if any 
  813. program intercepts a vector without using the XBRA protocol, then it 
  814. will break the chain and PROFILE 2 will not show any more XBRA IDs 
  815. even if some still exist. This is not PROFILE 2's fault but one 
  816. inherent in the system and will remain so until all programs use the 
  817. XBRA protocol.
  818.  
  819. A good example of an exception vector that gets used for this is 
  820. number 46 - TRAP #14 Instruction (XBIOS). Several programs may use 
  821. this vector to point to their routines, such as Quick ST3, OverScan, 
  822. NeoDesk etc.
  823.  
  824. XNAM protocol programs can't be chained and so don't need to maintain 
  825. the old address. They usually appear as VBL routines but the XNAM 
  826. protocol is rarely used and as such is basically just a naming device.
  827.  
  828. ST Applications Issue 11 November 1991 gives a good account of the 
  829. XBRA Protocol.
  830.  
  831.  
  832. PROFILE 2 - USING IT
  833. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  834. The program is run by double-clicking on it from the Desktop. Most of 
  835. the data is gathered and processed at the start. It may take a few 
  836. seconds or so.
  837.  
  838. IMPORTANT: If you get an Alert warning of a GEMDOS Internal Error, 
  839. then PROFILE 2 will quit immediately. It is not safe to continue 
  840. because some data on your drives may be lost. This isn't a problem 
  841. with PROFILE 2 but with GEMDOS itself. It is, however, extremely rare.
  842.  
  843. PROFILE 2 will run on all STs, STEs, TTs and Falcons and under 
  844. MultiTOS in all resolutions except 40 column modes which I won't 
  845. support! I make no apologies, please use a higher resolution.
  846.  
  847. On starting you will be presented with the main window and a menu bar. 
  848. The first page will be displayed. You can access all subsequent pages 
  849. from the Report menu or by pressing the <Return> key which will show 
  850. each page in turn. <Cntl><Return> will show the previous page. The 
  851. number pad <+> and <-> keys will also do the same. The <Clr Home> key 
  852. displays the first page and <Shift><Clr Home> displays the last page.
  853.  
  854. All the pages listed in the Report menu can be accessed by using the 
  855. Function keys as well. Some items have more than one page attached to 
  856. them and these will display a submenu for you to choose from. Only the 
  857. first page in a submenu is available through the Function Keys.
  858.  
  859. The display window can be moved, fulled, closed and scrolled with the 
  860. mouse in the usual manner. <Cntl><Esc> or <Cntl><W> will close the 
  861. window, the cursor keys will scroll the window by one line or column 
  862. or by one page if used with the <Shift> key. The window can be fulled 
  863. with <Cntl>numberpad<*>.
  864.  
  865. All dialogs are amodal and placed in windows so that you can move them 
  866. about, close them and act on them whilst also being able to view and 
  867. act on other open dialogs or windows. <Cntl><Esc> or <Cntl><W> will 
  868. close the dialog window, as will <Undo> which corresponds to the 
  869. Cancel key.
  870.  
  871. Most dialogs have the usual OK and Cancel buttons which operate in the 
  872. standard manner, i.e. 'OK' will bring about an action and close the 
  873. dialog. Some will also have an 'Apply' button which does the same as 
  874. 'OK' but doesn't close the dialog window.
  875.  
  876. The default position of the dialogs can be set to the screen centre, 
  877. mouse position or non (usually at the top of the screen). This is set 
  878. in the Dialogs Position menu item in the Options menu or called with 
  879. <Cntl>D.
  880.  
  881. You may choose a smaller system font to display the text in the 
  882. Options menu and therefore have a smaller window if you wish. 
  883. <Cntl>numberpad<-> and <Cntl>numberpad<+> will also change the font 
  884. size.
  885.  
  886. Under the File menu, each page, a selection of pages or the whole 
  887. report may be saved to disk with the default filename of PROFILE2.xxx, 
  888. where 'xxx' is either:
  889.  
  890.     'Pnn' for a single page and nn being the page number
  891.     'LST' for a selection of pages
  892.     'REP' for the whole report
  893.     'XBR' for a XBRA page
  894.  
  895. You may change this name and path when the file selector appears, of 
  896. course. The whole report will be about 45K long depending on your 
  897. system.
  898.  
  899. Each page, a selection of pages or the whole report may be saved to 
  900. the standard Atari Clipboard with the default filename of SCRAP.TXT. 
  901. PROFILE 2 will look for this clipboard and display a message if it 
  902. can't find it, probably because one hasn't been installed. PROFILE 2 
  903. won't install one for you on the premise that if you haven't got one 
  904. you don't want one. If you do want one then obtain CLIPBORD.CPX.
  905.  
  906. Each page, a selection of pages or the whole report may be printed via 
  907. the parallel printer port or serial port depending on where you have 
  908. your printer as installed in the control panel. You may wish to set up 
  909. your printer beforehand as some text lines in PROFILE 2 are longer 
  910. than the usual 80 columns.
  911.  
  912. Under the File menu item 'Printer Init' you can enter some Printer 
  913. Initialization codes as a series of character sequences (represented 
  914. as decimal numbers) separated by commas. These character strings are 
  915. the decimal ASCII command codes for the relevant sequences, so the 
  916. Epson control code for switching on 12 cpi Elite text is ESC M or 
  917. 27,77. You will enter "27,77" (without the quotes) in the 
  918. initialization line. A Hewlett-Packard control sequence for bold type 
  919. is ESC (s3B so you enter "27,40,115,51,66" (without the quotes). 
  920. You'll need to consult your printer manual for these codes. On a page 
  921. printer (laser, inkjet) you can send a form feed to eject the page 
  922. using the 'FormFeed' button in the Printer Initialization dialog.
  923.  
  924. However, you may find it easier to set up the printer from an 
  925. accessory or CPX if one is available. If printing off more than the 
  926. odd page, then save the pages to a disk file and format and print them 
  927. from within your favourite word processor.
  928.  
  929. These functions are unavailable unless you register.
  930.  
  931. These, and other options, together with the window size and position 
  932. can be saved to a PROFILE2.INF file which PROFILE 2 looks for every 
  933. time it loads. Therefore, you can have your printer codes, font size, 
  934. dialog position and window size and position available as the default 
  935. set up each time your run PROFILE 2. In addition, if you have the ST-
  936. Guide hypertext help system not installed as an accessory, then it's 
  937. path will also be stored in the PROFILE2.INF file.
  938.  
  939. Options can be saved or loaded at any time from the Options menu.
  940.  
  941. These functions are unavailable unless you register.
  942.  
  943. In the Systems Variables and Exception Vectors pages some addresses 
  944. are vector addresses that can be checked for XBRA and XNAM compliance. 
  945. The valid vectors are those with a number in the first column. The 
  946. XBRA check report window is obtained by double-clicking on any line or 
  947. calling the dialog to enter the number of the vector. This latter is 
  948. obtained by pressing <Cntl><X> or selecting the XBRA menu item under 
  949. the Options menu.
  950.  
  951. The XBRA check report window shows the relevant address and its value, 
  952. which should be another memory address. Attempts are made to check 
  953. this value - to see if it is in the ROM or illegal (pointing to 
  954. protected memory or outside that available to the system). If a XBRA 
  955. or XNAM compliant ID (four characters) is found then it is reported 
  956. and the next address in the chain is shown until the chain ends. 
  957. Please note that any check on a vector will only show if that vector 
  958. was installed by a XBRA or XNAM compliant program. Many programs, 
  959. especially older ones don't use this protocol. It doesn't make that 
  960. address pointed to by the vector less valid. It was installed by 
  961. something!
  962.  
  963. The contents of this XBRA window can be printed, saved to disk (with 
  964. the default filename PROFILE2.XBR) or sent to the clipboard as usual 
  965. unless you haven't registered.
  966.  
  967. The data displayed can be updated at any time by selecting the Re-Read 
  968. Data menu item in the Options menu or by pressing <Cntl><R>. This can 
  969. be useful in a multitasking situation or where accessories can change 
  970. the system, such as the Control Panel.
  971.  
  972. Rudimentary help is obtained by pressing the <Shift><Help> key or 
  973. selecting the Simple Help menu item. If you have ST-Guide a special 
  974. hypertext help document (not unlike this document) can be viewed 
  975. instead. ST-Guide can be installed either as an accessory or loaded 
  976. from within PROFILE 2. Simply place the PROFILE2.HYP and PROFILE2.REF 
  977. files in your ST-Guide HYP directory (normally called GUIDES). Press 
  978. <Help> from within PROFILE 2 to get help on the current page being 
  979. viewed or <Cntl><Help> to get the Contents page.
  980.  
  981. The program About dialog obtained with <Cntl><I> or from the PROFILE 2 
  982. menu displays some important information, the version number, 
  983. compilation date and acknowledgements as well as access to the 
  984. Registration dialog where you can enter your registration name and key 
  985. and obtain full access to the program.
  986.  
  987. The program can only be quit by pressing <Cntl><Q> or from the File 
  988. menu.
  989.  
  990.  
  991. PROFILE 2 - COMMAND KEYS
  992. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  993. PROFILE 2 follows the GEM-List key commands standard where 
  994. appropriate.
  995.  
  996. F1 to <Shift>F9       - Page selection
  997. Home                  - First page
  998. <Shift>Home           - Last page
  999. <Numberpad>+          - Next page
  1000. Return                - Next Page
  1001. <Numberpad>-          - Previous page
  1002. <Cntl>Return          - Previous page
  1003.  
  1004. Cursor                - Scroll window by line/column
  1005. <Shift>Cursor         - Scroll window by page
  1006. <Cntl>Up cursor       - Top of page
  1007. <Cntl>Down cursor     - Bottom of page
  1008.  
  1009. <Cntl>Esc
  1010. <Cntl>W               - Close top window
  1011. <Cntl>Tab
  1012. <Cntl>U               - Swap window to front
  1013. <Cntl><Numberpad>*    - Full top window
  1014. <Cntl>I               - About dialog
  1015. <Cntl>R               - Re-read data
  1016. <Cntl>X               - XBRA chain check
  1017. <Cntl>F               - Font selection
  1018. <Cntl><Numberpad>+    - Increase font size
  1019. <Cntl><Numberpad>-    - Decrease font size
  1020. <Cntl>D               - Dialog position
  1021. <Shift><Cntl>P        - Printer initialization string
  1022. <Cntl>O               - Save options
  1023. <Cntl>L               - Load options
  1024. Help                  - ST-Guide Help - Current Page
  1025. <Cntl>Help            - ST-Guide Help - Contents
  1026. <Shift>Help           - Simple Help
  1027. <Cntl>Q               - Quit
  1028.  
  1029. C                     - Clip current page
  1030. <Shift>C              - Clip range of pages
  1031. <Cntl>C               - Clip whole report
  1032. P                     - Print current page
  1033. <Shift>P              - Print range of pages
  1034. <Cntl>P               - Print whole report
  1035. S                     - Save current page
  1036. <Shift>S              - Save range of pages
  1037. <Cntl>S               - Save whole report
  1038.  
  1039. F1, F2, F3            - First, second and third buttons in Font or
  1040.                       Dialog position dialogs
  1041.  
  1042.  
  1043. PROFILE 2 - SOME COMMENTS
  1044. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  1045. I have written this program using legal methods everywhere, as far as 
  1046. I know. It has been extensively tested on nearly all TOS versions and 
  1047. all types of Atari computers all running MultiTOS and most of them 
  1048. running MagiC. It is currently being tested under MagiCMac as new beta 
  1049. versions of that program appear. As far as myself and the beta testers 
  1050. can ascertain all the information reported by PROFILE 2 is accurate. 
  1051. That is, what is reported is what is found by PROFILE 2. However, it 
  1052. may be that some strange figures are seen which appear at odds with 
  1053. what you know to be true. In many respects this is the point of 
  1054. running PROFILE 2. It will report the configuration that exists and 
  1055. not what you thought existed! Be very aware that running many 
  1056. different programs, such as accessories and AUTO programs, different 
  1057. hardware such a OverScan, accelerators, emulators etc. all affect the 
  1058. internal configuration of your computer. To make themselves known to 
  1059. the system and work they may well fiddle with some system variables, 
  1060. vectors, interrupts or even the apparent appearance of the ROM - all 
  1061. of which may or may not be what you thought or know to exist.
  1062.  
  1063. For instance, AutoSwitch OverScan messes with various system variables 
  1064. such as 'exec_os'. This system variable normally tells the system 
  1065. where the start of the AES is, like $E13D94 under TOS 1.6. That makes 
  1066. sense because the AES is in the ROM starting at $E00000 on TOS 1.6. 
  1067. But, OverScan can set this to something like $708C8 way down in RAM. 
  1068. Normally you may think this is a great mistake on PROFILE 2's part as 
  1069. it doesn't make sense - until you read the AutoSwitch OverScan manual 
  1070. and see that this is documented. However, not all software, by any 
  1071. means, documents what it is doing internally to your system - hence 
  1072. PROFILE 2!
  1073.  
  1074. Something else you may notice is that PROFILE 2 reports that you have 
  1075. less memory than you thought. This may well be because you have a RAM 
  1076. Disk installed that has altered the system variable 'phystop' to 
  1077. point, not to the top of physical memory, but to the memory address 
  1078. directly underneath the memory reserved for the RAM Disk. PROFILE 2 
  1079. will catch this.
  1080.  
  1081. Logbase and Physbase are two more vectors that cause concern. Physbase 
  1082. will normally point to the base of memory holding the data for the 
  1083. physical screen (the one actually displayed). Logbase normally points 
  1084. to the base of the logical screen (the one onto which any drawing by 
  1085. the GEM VDI is done). Usually these addresses are both the same but do 
  1086. not have to be. For instance, a program may have a screen displayed 
  1087. (at Physbase) whilst writing another (at Logbase) and swap between 
  1088. them for quick, snappy screen draws. However, AutoSwitch OverScan is a 
  1089. program that messes with these values to the extent that any call to 
  1090. Physbase will return the Logbase value when OverScan software is 
  1091. installed. If you didn't know this and are writing a program using 
  1092. Logbase and Physbase calls which repeatedly return the wrong values, 
  1093. PROFILE 2 will help solve this problem for you.
  1094.  
  1095. PROFILE 2 is as extensive as a program like this can be and yet remain 
  1096. compatible on all ST/TT/Falcon030 systems. That was of paramount 
  1097. importance when being written. There are some deficiencies in its 
  1098. reporting. These are for many reasons.
  1099.  
  1100. 1   I don't know about them. If you do then why not tell me what I
  1101.     missed.
  1102. 2   I didn't know how to find that data whilst retaining compatibility
  1103.     across all platforms.
  1104. 3   There is no acceptable means of finding that data using sensible,
  1105.     accurate and legal methods. The TT Fast RAM situation in the TT is
  1106.     a case in point. As far as I and several developers in the UK and
  1107.     Europe can ascertain, involving consultation with Atari UK and
  1108.     Atari US, there is no 100% reliable legal way to report the total
  1109.     amount of 32-bit Fast Alternative RAM in a TT. PROFILE 2 will
  1110.     report the amount of TT RAM using an undocumented feature which
  1111.     I'm taking a chance on. It should be all right.
  1112. 4   A detail may be of too little importance to report or too esoteric
  1113.     and used by only one or two people.
  1114. 5   Other programs do it better, like disk diagnostic programs or
  1115.     system speed analysers, such as GEMBench.
  1116. 6   A detail may require the presence of third party hardware which I
  1117.     consider to be outside the scope of this program.
  1118. 7   Others are moving the goal posts every day. I'm trying to keep up!
  1119.  
  1120. If you wish to comment on any of these points then please do, I am 
  1121. very receptive to program changes and suggestions and am not the sort 
  1122. of programmer that gets in a huff if someone complains of their work 
  1123. although totally thoughtless and destructive criticism may well get 
  1124. ignored! However, I am all too aware of my limitations and PROFILE 2 
  1125. isn't perfect by any means.
  1126.  
  1127.  
  1128. PROFILE 2 - BUGS AND PROBLEMS?
  1129. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  1130. PROFILE 2 has been tested by myself and many knowledgable beta testers 
  1131. all of whom have different systems. PROFILE 2 has been developed over 
  1132. much time and with much thought. Most problems have been eradicated 
  1133. hopefully. If you find anything wrong do tell me!
  1134.  
  1135. PROFILE 2 crashes under the Janus ST emulator card for the PC 
  1136. (although it works with GEMulator). No idea why at this stage.
  1137.  
  1138. When trying to print and the printer isn't on-line, an Alert should 
  1139. appear giving you the option to Quit or turn the printer on and 
  1140. continue. On some systems, usually Falcons, this Alert doesn't appear. 
  1141. We don't know why although I suspect it is a Lattice C library bug.
  1142.  
  1143. There is a limit of 250 lines of text per page, so that pages that 
  1144. show external ASCII files, such as MINT.CNF and ASSIGN.SYS etc. might 
  1145. be truncated if over this limit.
  1146.  
  1147. There are some minor problems with the data reports when running under 
  1148. MagiCMac but most of these are due to the compromises MagiCMac has to 
  1149. make running on Apple Mac hardware which is substantially different to 
  1150. Atari hardware. MagiCMac is still in development so many of these will 
  1151. be ironed out eventually.
  1152.  
  1153. PROFILE 2 - VERSION HISTORY
  1154. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  1155. V1.53
  1156.     March 1994
  1157.     The last version of PROFILE 1.
  1158.  
  1159. V2.0β release 1
  1160.     Beta test version tested June 1994
  1161.  
  1162. V2.0β release 2
  1163.     Beta test version tested July 1994
  1164.  
  1165. V2.0β release 3
  1166.     Beta test version tested September 1994
  1167.  
  1168. V2.0β release 4
  1169.     Beta test version tested November 1994
  1170.  
  1171. V2.0β release 5
  1172.     Beta test version tested November 1994
  1173.  
  1174. V2.0β release 6
  1175.     Beta test version tested December 1994
  1176.  
  1177. V2.0β release 7
  1178.     Beta test version tested December 1994
  1179.  
  1180. V2.08
  1181.     First release December 1994
  1182.  
  1183. V2.09β
  1184.     Beta test version tested February 1995
  1185.  
  1186. V2.10β
  1187.     Beta test version tested March 1995
  1188.  
  1189. V2.11β
  1190.     Beta test version tested March 1995
  1191.  
  1192. V2.12
  1193.     Release April 1995
  1194.  
  1195.     Bug fixes:
  1196. *   Submenus now work correctly on TTs.
  1197. *   Bug fixed where "Cookie Jar" submenu didn't work when main window
  1198.     was closed.
  1199. *   Bug fixed that caused a crash if some ASCII text files (such as
  1200.     MINT.CNF) weren't found at all.
  1201. *   Small bug fixed where F6 or F8 displayed a blank page if not
  1202.     running on a Falcon or Multitasking.
  1203. *   Small bug fix in function to get TT memory should speed up initial
  1204.     data gathering.
  1205. *   Bug fixed in "Memory" page which showed some values as having very
  1206.     large percentages.
  1207. *   Bug fixed in "Memory" page which showed "Free alternative TT TPA
  1208.     memory available" as zero under MultiTOS.
  1209. *   Bug fixed in "Accessories" page where multiple paths in the
  1210.     ACCPATH environment variable weren't searched correctly.
  1211. *   Bug fixed that caused the "Basepages" page to occasionally crash.
  1212. *   Small bug fixed in content of pages saved to disk or printed when
  1213.     that page exceeded the line limit.
  1214. *   ST-Guide now correctly launched under MagiC.
  1215. *   XBRA and XNAM checks now correctly searched for under operating
  1216.     systems loaded from disk, such as MagiC.
  1217.  
  1218.     Developments:
  1219. *   Some new code courtesy of Jon Ellis to detect CPU and FPU
  1220.     processors if the Cookie Jar isn't present. The Cookie Jar still
  1221.     takes precedence.
  1222. *   XBRA and XNAM checks now correctly cater for 32-bit addresses in
  1223.     the vector values, in particular those in Alternative RAM.
  1224. *   XBRA and XNAM page in ST-Guide now called if XBRA window is on top
  1225.     and ST-Guide called.
  1226. *   Total free memory and largest memory block available are now
  1227.     obtained under MiNT where before I followed Eric Smith's advice
  1228.     not to do this as it may cause problems with other processes. I
  1229.     now believe that the risk is minimal in PROFILE 2. As a
  1230.     consequence, the MiNT memory stats for drive U: are not now
  1231.     displayed.
  1232. *   Speed of initial data gathering under MagiC greatly increased.
  1233. *   "Screen memory" and "System memory" values now MagiCMac
  1234.     compatible.
  1235. *   "Cartridge" page disabled on MagiCMac.
  1236. *   Supexec() calls used instead of Super() for increased safety under
  1237.     multitasking systems, especially with virtual memory and
  1238.     interruptible file systems.
  1239.  
  1240.     New:
  1241. *   Pages now show their page number in the page title/window
  1242.     information line.
  1243. *   New "Applications" page showing currently running applications
  1244.     under multitasking systems.
  1245. *   "Serial Devices" page shows all Bconmap devices available,
  1246.     including the BCONMAP and IOREC structures.
  1247. *   The "Disk Drives" page now shows the BPB of all mounted drives
  1248.     where possible.
  1249. *   pun_info page shows whether the drive is physical or not.
  1250. *   MultiTOS (MiNT) Details page is now Multitasking System Details
  1251.     and the submenu varies depending on the system installed
  1252.     (MultiTOS, MagiC or Geneva) as do the details shown in these
  1253.     pages.
  1254. *   MultiTOS (MiNT) Details - MINT.CNF File page now shows MINT.CNF,
  1255.     MAGX.INF or GENEVA.CNF depending on system installed.
  1256. *   MultiTOS (MiNT) Details - GEM.CNF File page now shows the GEM.CNF
  1257.     file belonging to MultiTOS or Geneva depending on which system is
  1258.     installed.
  1259. *   MagiCMac cookie added to "Cookie Jar Interpretation" page.
  1260. *   Full AES data now shown if MagiC or Geneva are installed.
  1261. *   Some additional AES data for MagiC.
  1262. *   MagiC's AES shell buffer shown and correctly titled.
  1263. *   Only relevant data contained in MagiC's MAGX.INF file shown in the
  1264.     "Shell Buffer Installed Configuration" page.
  1265. *   Nag alert installed for non-registered versions.
  1266.  
  1267. V2.13
  1268.     Release April 1995
  1269.  
  1270.     Bug fixes:
  1271. *   Some BPB details on "Disk Drives" page may appear as negative
  1272.     values.
  1273. *   Problems with loading from floppy disk and obtaining BPB data,
  1274.     locks up if drive B not installed.
  1275.  
  1276. V2.14
  1277.     This release June 1995
  1278.     New:
  1279. *   The "CPU speed comparable to a 8 MHz 68000" item has been expanded
  1280.     and clarified in the program and text files.
  1281. *   Some slight cosmetic changes to the .RSC file.
  1282. *   In the "Important Addresses" page the memcntrl value now shows the
  1283.     whole value rather than the upper byte as it was causing some
  1284.     confusion.
  1285. *   Form feed added to end of print.
  1286.  
  1287.  
  1288. PROFILE 2 - THE FUTURE
  1289. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  1290. PROFILE 2 is still in development. Plans include:
  1291.  
  1292. More things to report as I and users think of them.
  1293.  
  1294. Multiple report windows.
  1295.  
  1296. Dialog windows responding to window cycling.
  1297.  
  1298. VCSR compatibility (apart from the dialogs).
  1299.  
  1300. Memory Monitor window to analyse address clicked on in any page.
  1301.  
  1302. New windows library improving some window behaviour.
  1303.  
  1304. No limit on page display size.
  1305.  
  1306. Ability to pass any word clicked on to ST-Guide for it to search for 
  1307. in it's REF files so enabling the user to build up there own HYP files 
  1308. of data on items PROFILE reports.
  1309.  
  1310.  
  1311. PROFILE 2 - THE ACKNOWLEDGEMENTS
  1312. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  1313. Thanks go to the beta testers of PROFILE 1, Lasse Eldrup; John Eason; 
  1314. Daniel Hastings; Daron Brewood; Paul Hargreaves and Steve Taylor and 
  1315. the beta testers for PROFILE 2, Daron Brewood; Joe Connor; Mark 
  1316. Davidson; Ofir Gal; Rob Perry; Darryl Piper; Chris Ridd; Brian Robson; 
  1317. Simon Robins; Bob Samuel and Jon Waite - all very generous and patient 
  1318. guys. PROFILE 2 wouldn't be anywhere near as useful without them - my 
  1319. warm thanks to you all for your testing, encouragement and patience.
  1320.  
  1321. Thanks to Jon Waite for the assembly code to calculate the effective 
  1322. processor speed. It slotted in beautifully!
  1323.  
  1324. A special thanks to Martin Maisey for his FLDLIB amodal dialogs 
  1325. library and to Simon Robins for his MENU submenu and popup menu 
  1326. library.
  1327.  
  1328. In no special order, thanks also for ideas, bits of code, inside 
  1329. details and encouragement to Mark Davidson, Darryl Piper, Rob Perry, 
  1330. Steve Taylor, Karl Foley, Eric Chapman, Ofir Gal, Graeme Rutt, Alex 
  1331. Kiernan, Chris Goodwin, Paul Alder, Stephen Nathan, Richard Gorbutt, 
  1332. Jon Ellis, Mathew Lodge, Kev Beardsworth and Flemming Nielsen. I 
  1333. apologise if I forgot anyone else who made some contribution to my 
  1334. knowledge or enthusiasm - these are all my memory and comms log-book 
  1335. recall.
  1336.  
  1337. Lastly, thanks to Jane, a supportive and understanding wife who has 
  1338. the extraordinary capability to listen to the complete load of rubbish 
  1339. I spout forth on my computing exploits and even remember it when I 
  1340. test her!! ;-)
  1341.  
  1342.  
  1343. Slàinte mhath
  1344. Mark S Baines
  1345. Linnhe Computing
  1346. 3rd June 1995
  1347.  
  1348. E-mail:
  1349. Internet:  msbaines@cix.compulink.co.uk
  1350. FidoNet:   2:254/105.10@fidonet.org
  1351. NeST:      90:102/107.0@nest.ftn
  1352. TurboNet:  100:101/12.10@turbonet.ftn
  1353. AtariNet   51:502/0.10@atarinet.ftn
  1354.